home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Word / C / Columnbo 2.1.cpt / Columnbo 2.1 / Columnbo 2.1.rsrc / TEXT_128_Columnbo info text.txt < prev    next >
Encoding:
Text File  |  1991-02-24  |  5.1 KB  |  111 lines
  1. Introduction
  2.  
  3.     Columnbo is an easy to use utility for formatting plain text files 
  4. into columns of information, allowing them to be read by a spreadsheet 
  5. program such as Excel‚Ñ¢.  This simply involves inserting tabs at fixed 
  6. positions within each line of text.  But the real beauty of Columnbo is 
  7. that you needn't worry about remembering column positions.  
  8. Columnbo gives you the control to place column positions where you 
  9. want, intuitively and easily.  Simply click in the ruler to drag column 
  10. markers where you wish.
  11.  
  12. What's it good for?
  13.  
  14.     Many popular spreadsheet, database, and graphing programs 
  15. allow you to import text files from various sources, but depend on 
  16. information being formatted into tab separated columns.  Columnbo was 
  17. originally conceived to allow importing columns of accounting figures 
  18. from a large computer into Excel‚Ñ¢.  This computer generated fixed 
  19. columns of text and figures separated by spaces.  Without embedded 
  20. tabs separating the columns, entire lines of text would be read into the 
  21. first cell of each row.  A convenient solution for this apparently simple 
  22. task was elusive, and nobody wanted to type in the tabs!
  23.  
  24. Using Columnbo
  25.  
  26.     To use Columnbo, choose "Open..." from the File menu to read 
  27. in your text file.  Then, click in the ruler at the top of the window to 
  28. insert a column marker where you'd like the tab to go.  The column 
  29. marker may then be dragged to any visible column in the window, or 
  30. removed by dragging it outside the window.  Dragging one column 
  31. marker over another results in that column being marked only once.
  32.  
  33.     Once you've positioned all your columns, choosing the "Save 
  34. as..." command from the File menu brings up a standard dialog box 
  35. with the filename filled in for you.  Columnbo creates a new file with 
  36. tabs inserted at the marked positions for each line.  Columnbo does not 
  37. alter the original file in any way.
  38.  
  39.     The Columnbo Edit menu supports standard editing commands 
  40. for use with desk accessories, and a "Clear columns" command which 
  41. clears all marked columns of the front window.
  42.  
  43.     From the Options menu, Columnbo offers several choices to 
  44. make your column formatting easier.  First, by selecting the "Show 
  45. tabs as ‚óä", you can see if there are any spurious tabs already in the 
  46. file.  The "Output options..." dialog box gives you the ability to filter 
  47. certain characters from the output file.  Choose "Convert pre-
  48. existing tabs to spaces" to ensure your file only contains tabs at the 
  49. column positions you have marked.  This feature also serves as a 
  50. convenient way to kill tabs in a file instead of inserting them.  The 
  51. "Remove leading spaces" option helps clean up the output columns. 
  52. This removes spaces between a column marker and the first character of 
  53. the next column.
  54.  
  55. Column templates
  56.  
  57.     Columnbo allows you to save lists of column templates in the 
  58. templates menu.  This is invaluable for working on similarly formatted 
  59. files.  Select the "Add..." command from the Templates menu to add the 
  60. columns list of the active window to the Templates menu.  Then, when 
  61. you're working with a new file, selecting a template from the menu will 
  62. automatically set the columns markers of the active window for you, 
  63. which you may modify further if desired.  Templates can be removed 
  64. from the Templates menu with the "Remove..." command.
  65.  
  66. Settings file
  67.  
  68.     Column templates are saved in the default settings file named 
  69. "Columnbo settings".  This file is created for you automatically in the 
  70. system folder.  You may keep several versions of this if you wish by 
  71. simply dragging the settings file from the system folder and renaming 
  72. it.  Then, start Columnbo by opening one of these instead of Columnbo 
  73. itself.  You may also load a new settings file "on the fly" with the 
  74. "Open..." command.
  75.  
  76. Acknowledgments
  77.  
  78.     This program was conceived by Dave Astolfi who needed to load 
  79. accounting information into Excel‚Ñ¢. For me, it's been great working 
  80. on a practical application while learning how to program my Macintosh 
  81. in C. Special thanks to Dave for all his encouragement, and to Ray 
  82. Uttaro, who has been very helpful in catching the bugs that got away!
  83.  
  84. Limitations
  85.  
  86.     Columnbo expects text files to have line breaks (a return) at the 
  87. end of each line, and Lines may be no longer than 256 characters in 
  88. length.
  89.  
  90.     Columnbo can only handle files of up to 32K in length since it 
  91. uses the built-in toolbox TextEdit routines to display and scroll text.  
  92. However, registered users will receive the latest version of Columnbo 
  93. which removes this limitation and adds other features, such as adjustable 
  94. delimiter and line break characters, tab expansion, etc.
  95.  
  96. Motivation fund
  97.  
  98.     This program is distributed as Shareware, so please pass it along 
  99. to your friends or upload it to your favorite BBS. If you use it, please 
  100. send $15 or what you think it's worth (or even a few comments on a 
  101. postcard) to:
  102.  
  103.         David Craig
  104.         48 Cedar Circle
  105.         Randolph, MA 02368
  106.  
  107.         craig@submicron.ll.mit.edu
  108.  
  109.         Also, please jot down where you came across Columnbo. Thanks!
  110.  
  111.         Columnbo ¬© 1991 by David M. Craig. All rights reserved.